Skip to content

Conversation

lcawl
Copy link
Contributor

@lcawl lcawl commented Aug 28, 2025

There are two copies of the start-local installation instructions: https://www.elastic.co/docs/solutions/search/run-elasticsearch-locally and https://www.elastic.co/docs/deploy-manage/deploy/self-managed/local-development-installation-quickstart. This PR updates links to target the latter and removes the former.

This PR must be merged after elastic/elasticsearch#133691

@github-actions
Copy link

github-actions bot commented Aug 28, 2025

@lcawl lcawl marked this pull request as ready for review August 28, 2025 20:34
@lcawl lcawl requested review from a team as code owners August 28, 2025 20:34
@lcawl lcawl enabled auto-merge (squash) August 29, 2025 15:18
Copy link
Collaborator

@shainaraskas shainaraskas left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

can you give me some background on this change? one thing that was asked for by steve (search pm) was that you wouldn't have to change contexts too much when trying to get up and running with search just to play around. the way it was organized was pretty low maintenance as it used a single snippet.

that being said, if dev docs is ok with it I'll 🤐

@leemthompo
Copy link
Contributor

I'm guessing this is an SEO thing, but I share Shaina's concerns, I think having not having this page in the solutions/search nav is a loss in terms of visibility given we have so many entry points for lost users. start-local is a one-liner and IIRC we used this snippet approach because we basically wanted to plaster the docs surfaces with pointers to this super fast local setup option.

It's not a hill I will even start climbing though, not to mind die on 😃

@lcawl
Copy link
Contributor Author

lcawl commented Sep 2, 2025

can you give me some background on this change? one thing that was asked for by steve (search pm) was that you wouldn't have to change contexts too much when trying to get up and running with search just to play around

Sure, it's tied up in efforts to clean up and get consistency in the "Solutions and use cases" > xxx > "Get started" sections.
When this duplicate start-local page is gone, the next step is to address #1480 by cleaning up the out-dated serverless getting started page (and likely consolidating it into the main get started page akin to what was done for Observability).

That's a thought-provoking ask from Steve so will definitely take that into consideration as we keep revising this content.

I'm guessing this is an SEO thing, but I share Shaina's concerns, I think having not having this page in the solutions/search nav is a loss in terms of visibility given we have so many entry points for lost users. start-local is a one-liner and IIRC we used this snippet approach because we basically wanted to plaster the docs surfaces with pointers to this super fast local setup option.

I have indeed seen the one-liner plastered around and think it's okay to continue to do so without necessarily hanging onto duplicate pages. I've re-added the curl command that existed within quickstarts to #2248 so it keeps prominence in https://www.elastic.co/docs/solutions/search/get-started

Copy link
Collaborator

@shainaraskas shainaraskas left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

changes in deploy-manage section look ok. will let dev docs decide whether the page removal makes sense.

Copy link
Contributor

@leemthompo leemthompo left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No serious pushback from me, thanks for the context @lcawl

@lcawl lcawl merged commit 85ba029 into elastic:main Sep 3, 2025
7 checks passed
@leemthompo
Copy link
Contributor

This reminds me that we probably need to add telemetry to these start-local links in the docs

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants